メインコンテンツまでスキップ

20.SHIELDGate 파일 목록에서 파일 열기 및 경로 이동 기능 제공

버전 관리​

버전작성자일자변경 내용
1.0오남규2024-11-18최초 작성
1.1오남규2024-11-19내용 수정

SHIELDGate 파일 목록에서 파일 열기 및 경로 이동 기능 제공

1. 목적​

이 문서는 SHIELDGate에서 파일 열기 및 경로 이동 기능을 설계하고 구현하기 위한 지침으로, 다음과 같은 목표를 달성하기 위해 작성되었다.

  1. 사용자 편의성 향상: 파일 열기 및 경로 이동 기능을 제공하여 사용자가 필요한 작업을 빠르고 정확하게 수행할 수 있도록 한다.
  2. 보안 유지: 파일 열기 및 다운로드 정책을 통해 보안 요구 사항을 충족하며, 사용자 작업 이력을 시스템에 기록한다.
  3. 유지보수 용이성: 파일 형식에 따른 동작 로직과 경로 이동 처리가 유연하게 확장 가능하도록 설계한다.

2. 행위자​

  • 주요 행위자: SHIELDGate 사용자
    • SHIELDGate GNB(Global Navigation Bar)에서 파일을 열거나 경로 이동 작업을 수행하는 사용자.
  • 시스템: SHIELDGate 및 SHIELDrive
    • 사용자 요청에 따라 파일 열기, 경로 이동, 다운로드 동작을 처리하고 결과를 제공하는 시스템.

3. 사전 조건​

  1. 사용자가 SHIELDGate GNB(Global Navigation Bar) 영역에서 파일 아이콘을 클릭하여 파일 목록 팝업을 활성화한다.
  2. 파일 목록에는 사용자가 접근할 수 있는 파일 형식 및 수정된 날짜가 명확히 표시되어 있어야 한다.
  3. 파일 열기, 경로 이동, 다운로드 정책이 시스템에 설정되어 있어야 한다.
  4. SHIELDrive와 연동된 경로 이동 기능이 정상적으로 작동 중이어야 한다.

4. 사후 조건​

  1. 사용자가 파일 열기(공동 편집, 뷰어 열기, 다운로드) 또는 경로 이동 작업을 성공적으로 수행한다.
  2. 다운로드 정책에 따라 제한된 작업은 사용자에게 명확히 안내된다.
  3. 모든 파일 작업(열기, 이동, 다운로드)에 대한 로그가 시스템에 기록된다.

5. 기본 흐름​

  1. 사용자가 파일 목록에서 파일 이름 또는 파일 크기 위에 마우스를 올린다.

    • 시스템: 파일 크기 영역에 경로 이동 아이콘을 표시한다.

  2. 사용자가 경로 이동 아이콘을 클릭한다.

    • 시스템: 해당 파일이 포함된 경로를 SHIELDrive의 새 탭에서 연다.

  3. 사용자가 아이콘 영역 외의 파일을 클릭한다.

    • 시스템: 파일 형식을 판별하여 아래와 같이 동작한다:
      • 공동 편집 지원 파일: SHIELDGate 공동 편집 기능으로 파일을 연다.
      • 뷰어 지원 파일: SHIELDGate 뷰어로 파일을 연다.
      • 뷰어 미지원 파일: 다운로드 정책을 확인한 후 동작.
        • 다운로드 허용: 파일 다운로드.
        • 다운로드 차단: "다운로드가 제한된 파일입니다." 메시지 표시.

6. 대체 흐름​

A1. 파일 열기 실패​

  • 상황: 사용자가 파일을 클릭했으나, 시스템에서 파일을 열 수 없는 경우.
    • 시스템: 사용자에게 "파일 열기에 실패하였습니다. 문제가 지속될 경우 관리자에게 문의하세요."라는 메시지를 표시하고, 관리자에게 문의할 수 있도록 안내한다.

A2. 권한 없는 파일 접근​

  • 상황:

    1. 사용자가 뷰어도 미지원하는 파일을 클릭했으나, 다운로드 정책에 의해 다운로드가 차단된 경우.

    2. 편집이 지원되는 파일에 대해서 클릭하였을 때, 편집, 열람, 다운로드 정책이 모두 차단되었을 경우.

    3. 열람이 지원되는 파일에 대해서 클릭하였을 때, 열람, 다운로드 정책이 모두 차단되었을 경우.

    • 시스템: 사용자에게 "접근 권한이 차단된 파일입니다."라는 메시지를 표시한다.

7. 추가 확인 사항​

  1. 사용자 경험(UI/UX)

    • 마우스 hover 시 경로 이동 아이콘이 즉각적으로 표시되는지 확인.
    • 파일 이름 클릭 시 파일 형식별로 올바르게 동작하는지 확인.
    • 다운로드 제한 파일에 대해 명확한 경고 메시지가 표시되는지 점검.

  2. 정책 적용

    • 다운로드 정책(허용, 망연계 사용, 다운로드 차단)이 정확히 반영되는지 확인.
    • 망연계 솔루션과의 연동 및 요청 상태 확인이 원활히 이루어지는지 점검.

  3. 시스템 통합

    • SHIELDGate와 SHIELDrive 간의 경로 이동 기능이 정확히 동작하는지 확인.
    • 파일 열기, 다운로드, 이동 작업에 대한 로그가 정상적으로 기록되는지 확인.

8. 개발 및 디자인 고려사항​

개발팀​

  1. 파일 형식에 따른 동작 분기 처리:
    • 공동 편집, 뷰어 열기, 다운로드 차단/허용 등의 동작을 명확히 분리.
  2. 경로 이동 시 SHIELDrive와 연동된 API 호출 안정성 확보.
  3. 로그 기록: 사용자 작업 이력을 보안 로그에 저장할 수 있도록 구현.

디자인팀​

  1. UI/UX 설계:
    • 파일 목록 hover 시 경로 이동 아이콘과 파일 이름/크기 간 시각적 구분 제공.
    • 다운로드 차단 메시지 및 알림 UI를 사용자 친화적으로 설계.
  2. 정책 적용에 따른 메뉴 상태 표시:
    • 경로 이동, 다운로드 차단, 망연계 요청 버튼 상태를 정책에 따라 다르게 표시.